home *** CD-ROM | disk | FTP | other *** search
Text File | 1985-09-30 | 52.9 KB | 2,707 lines |
-
-
-
-
-
-
-
-
-
-
-
-
-
- Still River Shell
-
- User and Reference Guide
-
-
-
-
-
-
-
-
-
-
- Abridged Diskette Version 1.19
-
- September 30, 1985
-
-
-
-
-
- (c) Copyright Bob Howard 1985
- All rights reserved.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Still River Shell
-
-
-
-
-
-
-
- Table of Contents
-
-
- Chapter 1 License 3
-
- 1.1 Bearer License 3
- 1.2 User Support 3
- 1.3 Acknowledgments 3
-
- Chapter 2 User Guide 4
-
- 2.1 The Still River Shell 4
- 2.2 Optional Performance Consideration 5
- 2.3 Futures 5
- 2.4 Note of Caution 5
- 2.5 Demonstration Session 7
-
- 2.5.1 Set Up 7
- 2.5.2 Initial Screen 8
- 2.5.3 Sample Operations 8
-
- Chapter 3 Reference Guide: Command Summary 12
-
- 3.1 CHDIR 13
- 3.2 COPY 14
- 3.3 DELETE 16
- 3.4 FIND 17
- 3.5 INFO 18
- 3.6 LIST 19
- 3.7 MOVE 21
- 3.8 OPTIONS 23
- 3.9 RENAME 25
- 3.10 SORT 26
- 3.11 TREE 27
- 3.12 VIEW 28
- 3.13 WRITE 29
- 3.14 XDOS 30
- 3.15 <function_key> 32
-
- Chapter 4 User Guide: Still River Shell Techniques 34
-
- 4.1 High Performance Option 34
- 4.2 Second Operand Selection 34
- 4.3 Restoring the Screen 35
- 4.4 Media Replacement 35
-
- 4.4.1 Insufficient Space 36
- 4.4.2 Change of System Default Drive Media 36
-
-
-
-
-
-
-
-
-
-
- Still River Shell
-
-
-
- 4.5 Backup a Directory 36
- 4.6 Restore a Directory 37
- 4.7 Rename a Directory 37
- 4.8 Command <function_key> Usage 38
-
- 4.8.1 Print a File 38
- 4.8.2 Edit a File 39
- 4.8.3 Execute a File 39
- 4.8.4 Transmit a File 39
- 4.8.5 Backup the Set 39
- 4.8.6 Shell Help 40
- 4.8.7 FIND List <function_key> 40
- 4.8.8 Command Key Definition Standards 40
-
- 4.9 Saving and Using Shell File Lists 40
- 4.10 Hints For Using Hard Disks 41
-
- 4.10.1 Shared Logic Directory 41
- 4.10.2 Prevent Accidental Formatting 42
- 4.10.3 Improve Hard Disk Performance 42
-
- 4.11 Memory Usage 43
-
- 4.11.1 Nested Shell Calls 43
- 4.11.2 Out of Memory - Command Response 44
- 4.11.3 Memory Cost 45
-
- Chapter 5 Reference Guide: Command Usage 46
-
- 5.1 Usage 46
-
- 5.1.1 Command Syntax 46
- 5.1.2 Command Window 46
- 5.1.3 Command Set 46
- 5.1.4 Command Selection 46
- 5.1.5 Command Edit 47
- 5.1.6 Command Execution 48
- 5.1.7 Command Response 48
- 5.1.8 Command Object Set 48
- 5.1.9 Command Extensions 48
-
- 5.1.9.1 Query 48
- 5.1.9.2 Media Replacement 49
- 5.1.9.3 Target File Protection 49
-
- 5.1.10 User Defined Commands 49
-
- Chapter 6 Reference Guide: Window Definitions 51
-
- 6.1 Initial Command Selection Presentation 51
-
- 6.1.1 Set List Window 51
- 6.1.2 Data Window 51
-
-
-
-
-
-
-
-
-
- Still River Shell
-
-
-
- 6.1.3 Command Window 52
-
- 6.2 FIND Presentation 53
-
- 6.2.1 Set List Window 53
- 6.2.2 Data Window 53
- 6.2.3 Command Window 54
-
- 6.3 TREE Presentation 54
-
- 6.3.1 Set List Window 54
- 6.3.2 Data Window 55
- 6.3.3 Command Window 56
-
- 6.4 Object Set List Window 56
-
- Chapter 7 Reference Guide: Message Summary 57
-
- 7.1 Shell Informational Messages 57
- 7.2 Query Messages 59
-
- Chapter 8 A Little Design Philosophy 61
-
- Index
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Still River Shell License
-
-
-
-
-
-
-
-
-
- Chapter 1
-
- License
-
-
-
-
- 1.1 Bearer License
-
-
- This abridged documentation is intended for diskette distribution
- with the Still River Shell program. You may copy and distribute
- this documentation as long as you make no change to the document
- or charge a fee beyond media and handling ($9 Max). See the INFO
- command in the shell program for information about obtaining the
- printed, unabridged documentation and the latest version of the
- program.
-
-
-
-
- 1.2 User Support
-
-
- If you use the shell, please help underwrite the cost of its
- development by sending us a small contribution. See the shell's
- INFO command to find out how to make a contribution which
- entitles you to program update notices and a credit towards
- orders of future versions. Your support now will help us
- continue our work and make future releases possible.
-
-
-
-
- 1.3 Acknowledgments
-
-
- Thanks to all who helped including the Boston Computer Society's
- PC Technical Group which supplied many of our Beta Testers and
- much needed encouragement. Almost all of the program was written
- using Lattice C. The documentation was prepared using The
- FinalWord word processor.
-
-
-
-
-
-
-
- - 3 -
-
-
-
-
-
-
- Still River Shell Introduction
-
-
-
-
-
-
-
-
-
- Chapter 2
-
- User Guide
-
-
-
-
- 2.1 The Still River Shell
-
-
- The Still River Shell presents an enhanced PC-DOS environment.
- The shell allows the DOS user much greater efficiency than the
- standard DOS interface affords. Typical DOS functions of
- executing, finding, copying, moving, deleting and listing of
- files and directories can be done with significantly fewer key
- strokes when using the Still River Shell; recursive operations
- produce even greater efficiencies. And the shell provides a
- natural, intuitive interface which makes using DOS both more fun
- and more productive.
-
- You save a lot of work and time using the Still River Shell
- through the substantial elimination of command and operand
- typing. The shell allows you to use directly system information,
- such as file and directory lists, without having to copy the data
- from the screen and reenter it on your command line. You can
- select common commands without typing them. You can recall, edit
- and reenter DOS commands from the shell's prior DOS command
- stack. A powerful feature allows you to define your own
- extensions to the Still River Shell's command set. The Shell's
- full screen, real time presentation makes it an ideal system
- interface for mass storage systems such as the IBM/XT and
- IBM/AT.
-
- We could go on about the virtues of the shell, as we did in an
- earlier version of this document, but the best way to find out
- about the shell is to use it. The shell is designed to grow on
- you; you can use the shell productively right away while you
- learn about its other features. You may find it helpful to
- follow along during the demonstration session and to review
- briefly the commands in the reference guide.
-
- We hope you like the Still River Shell as much as we do.
- Remember, it is now your program too! Help support the Shell by
- sending your comments and contribution (see the INFO command).
- Thank you for your interest and support.
-
-
-
-
- - 4 -
-
-
-
-
-
-
- Still River Shell Introduction
-
-
-
-
-
-
-
- 2.2 Optional Performance Consideration
-
-
- The shell's performance, as well as that of many other programs,
- is much improved by instructing PC-DOS to keep a pool of IO
- Buffers numbering 14 or so. These buffers, used by DOS to speed
- up disk reads, are allocated by PC-DOS at "boot" time either by
- default or as specified in the CONFIG.SYS file.
-
- Either edit an existing CONFIG.SYS file or, if there is none,
- create a new one. The CONFIG.SYS file should be in the root
- directory (\). The CONFIG.SYS should read in part:
-
-
- BUFFERS=14
-
- If you prepare that file now, we can BOOT under our new
- configuration. If you do not wish to do it now, try to remember
- to do it later.
-
-
-
-
- 2.3 Futures
-
-
- For every published work there comes a time when you have to say:
- "It's done" or at least "Version 1 is done". When, after two
- years of design and development, that time came for the Still
- River Shell, some of what we intended was not there. We hope to
- add, with your support, additional functions in the future.
-
- How the Shell develops in the future depends a great deal on the
- experiences and wishes of you, the shell user and supporter.
- Suggestions accompanied by contributions will be accorded the
- attention they deserve! In fact, it is you, the shell user, who
- will decide if there will be any future releases of the shell.
- We can not continue our work without your support.
-
-
-
-
- 2.4 Note of Caution
-
-
- The Still River Shell is a powerful system utility and you should
- take care when using it. While the shell has had significant
- design work to help insure proper operation as well as extensive
-
-
-
- - 5 -
-
-
-
-
-
-
- Still River Shell Introduction
-
-
-
- ALPHA and BETA testing to insure its proper execution, the shell,
- like all programs, can fail, or a user, like all users, can err.
- Operation of the shell is at the user's risk.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 6 -
-
-
-
-
-
-
- Still River Shell Introduction
-
-
-
-
-
-
-
- 2.5 Demonstration Session
-
-
- 2.5.1 Set Up
-
- Please prepare a diskette with only the Still River Shell
- (SR.EXE) on it; we will use this diskette as our practice area.
- Mount the diskette on Drive A.
-
- Now, select the system default drive and a directory with at
- least 25 files, the more the better, as the current default
- directory. You may do this when you start the shell by
- specifying:
-
-
- ?>A:SR C:\MYDIR
- start the shell (A:SR)
- select system default drive (C:)
- select system current directory (\MYDIR)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 7 -
-
-
-
-
-
-
- Still River Shell Demonstration Session
-
-
-
-
-
- 2.5.2 Initial Screen
-
- When the shell starts, it presents the initial screen.
-
- As you can see, there are three main areas, or windows, on the
- initial screen:
-
-
- =================================
- | | |
- | | |
- | | |
- | | |
- | SET | DATA |
- | | |
- | | |
- | | |
- | | |
- =================================
- | COMMAND |
- =================================
-
- - Set List Window on the left is used to list the selected set
- of files and directories, <selected_set>.
-
- - Data Window on the right contains summary information about
- the <default_drive>, <selected_directory> and <selected_set>
- or other context sensitive data.
-
- - Command Window at the bottom of the screen is used to select
- and to enter commands as well as to receive responses and
- obtain help.
-
-
- 2.5.3 Sample Operations
-
- Now that you have the shell started, try the following shell
- operations:
-
- To copy a file from the <selected_set> to the practice diskette,
- perform the following steps:
-
- 1. You select a command by entering the letter, upper or lower
- case, equal to the upper case letter in the command name.
- In the case of COPY, <C>. The <selected_command> and the
- <selected_file> appear on the command input line in the
- Command Window.
-
- 2. Move the file <selector> with the <UP/DOWN CURSOR> keys to
- the file you wish to copy. Note: that the first operand on
-
-
-
- - 8 -
-
-
-
-
-
-
- Still River Shell Demonstration Session
-
-
-
- the command line changes as you move the <selector>.
-
- 3. Enter the <to_file> operand, in this case, <A:>
-
- 4. Enter <CR> to execute the command.
-
- To copy another file to A:,
-
- 1. Move the file <selector> to the file you wish to copy.
-
- 2. Enter <CR> to execute the copy.
-
- To copy some but not all files with a particular extension, e.a.
- <.BAT>:
-
- 1. Enter <ESC> to return to command selection.
-
- 2. Enter <S> to select sort.
-
- 3. Enter <E> to sort by extension.
-
- 4. Enter <ESC> to return to command selection.
-
- 5. Enter <C> to select copy.
-
- 6. Move the file <selector> to the first file with the desired
- extension.
-
- 7. Enter <A:> to set <to_file>.
-
- 8. Enter <CR> to execute the copy.
-
- 9. Move to the file <selector> to the next file to be copied.
-
- 10. Enter <CR> to execute the copy.
-
- 11. Repeat the last two steps until each file you wish to copy
- is copied.
-
- To edit the command line to copy all files of a specific
- extension, e.a. <.BAT>
-
- 1. Position the command line cursor at the first letter of the
- <from_file> in the command text. For example:
-
- COPY LAST.BAT A:
- ^
-
- 2. Delete the first part of the filename by entering <DEL>
- until the <from_file> is deleted up to the period changing
- <LAST.BAT> to <.BAT>.
-
-
-
-
- - 9 -
-
-
-
-
-
-
- Still River Shell Demonstration Session
-
-
-
- 3. Enter <*> so the command line reads <COPY *.BAT A:>.
-
- 4. Enter <CR> to execute the copy. Note: the copy command
- places a list of the files copied in the Set List Window.
-
- 5. Enter <ESC> to return to command selection.
-
- To List a new current directory:
-
- 1. Enter <L> to select LIST function.
-
- 2. Enter <directory_name>.
-
- 3. Enter <CR> to execute the change directory and list all
- files in the new directory.
-
- To enter and execute a PC-DOS command:
-
- 1. Enter <X> to select the EXECUTE DOS command presentation.
-
- 2. Enter <DIR *.*><CR> to execute command under DOS.
-
- 3. Enter <DATE><CR> to execute command under DOS.
-
- 4. Respond to DATE with <CR>.
-
- To recall your prior DOS commands:
-
- 1. Enter the <UP CURSOR> twice. You should see the DATE
- command and then the DIR command.
-
- 2. Move the cursor to the first <*> and delete <*.*> with
- <DEL>.
-
- 3. Replace the deleted operand with the <selected_file> by
- entering <INS>.
-
- 4. Enter <CR> to execute the edited command line.
-
- 5. Enter <ESC> to return to command selection.
-
- To delete some of the files on a:
-
- 1. Enter <L> to select the LIST function.
-
- 2. Enter <A:> to select a new DOS default drive to A
-
- 3. Enter <CR> to change <default_drive>, list all files on
- <drive a:>'s current directory.
-
- 4. Move the file <selector> to the first file to be deleted.
-
-
-
-
- - 10 -
-
-
-
-
-
-
- Still River Shell Demonstration Session
-
-
-
- 5. Enter <D> to select the delete command.
-
- 6. Enter <CR> to delete the file.
-
- 7. Move the file <selector> to the next file you wish to
- delete.
-
- 8. Enter <CR> to delete the file.
-
- 9. Enter <ESC> to return to command selection.
-
- You are on your way! Try the TREE command next, it gives a nice
- visual presentation of your directory structure as well as
- allowing you to MAKE, REMOVE or LIST directories. Try all the
- commands. Watch out for DELETE and MOVE; they can delete files
- you may miss.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 11 -
-
-
-
-
-
-
- Still River Shell Command Summary
-
-
-
-
-
-
-
-
-
- Chapter 3
-
- Reference Guide: Command Summary
-
-
-
- The following is a summary of the Still River Shell commands.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 12 -
-
-
-
-
-
-
- Still River Shell CHDIR
-
-
-
-
-
-
-
- 3.1 CHDIR
-
-
- Command CHDIR
-
- Function To change the current directory under the shell,
- use the LIST command or the LIST subcommand of
- the TREE command.
-
- Operand 1
-
- Operation
-
- Options
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 13 -
-
-
-
-
-
-
- Still River Shell COPY
-
-
-
-
-
-
-
- 3.2 COPY
-
-
- Command COPY <from_file_set> [<to_file_set>] [/Q]<CR>
-
- Function The COPY command copies the entire contents of
- the <from_file> creating a new <to_file>.
-
- Operand 1 <from_file_set> Any standard DOS file
- specification
- [<drive>:][\][<directory>\][<file_name>].
-
- Operand 2 <to_file_set> Any standard DOS file specification
- or blank.
-
- Operation COPY FILEA FILEB
-
- Copies FILEA to FILEB in the current directory.
-
- COPY *.ASM \SAVE
-
- Copies all files in the current directory with an
- <.ASM> extension to the <\SAVE> directory.
-
- Should there be no more room on the target disk,
- the copy prompts:
-
-
-
- ^ insufficient space; retry on new disk? (y/n)
-
- If you change the disk and enter <Y>, the COPY
- will resume copying the <file_set> starting with
- the complete file that did not fit on the prior
- media. You may use as many media as you need to
- complete the <file_set> COPY.
-
- If you wish to concatenate files, use the DOS
- COPY command.
-
- 1
- Options Option (1) Write on existing files
-
-
-
- ----------
-
- 1. See the OPTION Command
-
-
-
- - 14 -
-
-
-
-
-
-
- Still River Shell COPY
-
-
-
- Option (3) or </Q> Query on multiple operations.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 15 -
-
-
-
-
-
-
- Still River Shell DELETE
-
-
-
-
-
-
-
- 3.3 DELETE
-
-
- Command DELETE <file_set> [/Q]<CR>
-
- Function The DELETE command deletes all files in the
- <file_set> specification.
-
- Operand 1 <file_set> Any standard DOS file specification
- [<drive>:][\][<directory>\][<file_name>].
-
- Operation DELETE *.ASM
-
- Deletes files in the current directory with an
- <.ASM> extension. When a wild card, <*> or <?>,
- is used in the file name, the set of deleted
- files is presented in the Set Window.
-
- DELETE <selected_file>
-
- Deletes the highlighted, <selected_file> in the
- current set window. After the <selected_file> is
- deleted, an adjacent file is selected as the new
- <selected_file> in both the Set Window and the
- command line.
-
- Options Option (3) or </Q> Query on multiple operations.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 16 -
-
-
-
-
-
-
- Still River Shell FIND
-
-
-
-
-
-
-
- 3.4 FIND
-
-
- Command FIND <file_set><CR>
-
- Function The FIND command creates an ordered list
- (<drive>\<dir>\<file_name>) of all files within
- the <file_set>.
-
- Operand 1 <file_set> Any standard DOS file specification
- [<drive>:][\][<directory>\][<file_name>]. NOTE:
- Drive and directories can be specified with a
- wild card <?> or <*>.
-
- Operation FIND FILEA.BAT
-
- Lists any FILEA.BAT in any directory on the
- current drive.
-
- FIND C:*.*
-
- Finds all files in all directories on disk <C:>.
-
- FIND \DIR4\*.bat
-
- Finds all <.BAT> files in directory \DIR4.
-
- FIND \DIRX\*\*.BAT
-
- Finds all <.BAT> files in any subdirectory of the
- <DIRX> directory.
-
- FIND \*\CMD\*.BAT
-
- Finds all <.BAT> files in a <CMD> subdirectory of
- any parent directory.
-
- FIND *:*.*
-
- Finds all files on all drives from a to z.
-
- Options None.
-
-
-
-
-
-
-
-
-
- - 17 -
-
-
-
-
-
-
- Still River Shell INFO
-
-
-
-
-
-
-
- 3.5 INFO
-
-
- Command INFO
-
- Function The INFO command displays license information
- including our address, suggested contribution,
- credits and how to order the latest versions of
- the Still River Shell program and unabridged
- documentation.
-
- Operand 1 None.
-
- Operation Strike any key to see next page.
-
- Options None.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 18 -
-
-
-
-
-
-
- Still River Shell LIST
-
-
-
-
-
-
-
- 3.6 LIST
-
-
- Command LIST [<drive>:] [<path>] [<file_set>] <CR>
-
- Function The LIST command presents an ordered list of
- files and subdirectories from a
- <selected_directory> based on the <file_set>
- specification. In addition, the LIST command can
- change the system's default drive and current
- directory to a specified drive or directory. The
- <selected_directory> always becomes the system
- current directory when the LIST command
- executes.
-
- Operand 1 <file_set> Any standard DOS file specification
- [<drive>:][\][<directory>\][<file_name>].
- Default: <*.*>.
-
- Operation The initial <file_set> list is presented in file
- name order. If a directory is specified in the
- <file_set>, the specified directory is listed and
- it becomes the default <selected_directory> for
- all subsequent shell and DOS operations. If a
- drive is specified, it becomes the system's
- default drive. If a drive is specified but no
- directory is specified, the current directory of
- the drive is assumed.
-
- LIST *.BAT
-
- Lists all <.BAT> files in the current default
- <selected_directory>.
-
- LIST ..
-
- Changes the default <selected_directory> from the
- current directory to its parent and lists all
- files in the new <selected_directory>.
-
- LIST C:
-
- Makes the <default_drive> drive <C:> and lists
- all files in the default directory for the
- drive.
-
- LIST B:\
-
-
-
-
- - 19 -
-
-
-
-
-
-
- Still River Shell LIST
-
-
-
- Makes the <default_drive> drive <B:> and lists
- all files in the root directory of the drive.
-
- LIST A:ACCT*.*
-
- Assuming the <default_drive> is <C:>, this
- command changes the <selected_drive> to drive
- <A:>, assumes the default current directory of
- the drive <A:> and lists all files in the default
- directory with <ACCT> in the first four
- characters of the file name.
-
- Options None.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 20 -
-
-
-
-
-
-
- Still River Shell MOVE
-
-
-
-
-
-
-
- 3.7 MOVE
-
-
- Command MOVE <from_file_set> [<to_file_set>] [/Q]<CR>
-
- Function The MOVE command establishes the entire contents
- of the <from_file> under the identity of a new
- <to_file> name and deletes the <from_file>.
-
- Operand 1 <from_file_set> Any standard DOS file
- specification
- [<drive>:][\][<directory>\][<file_name>].
-
- Operand 2 <to_file_set> Any standard DOS file specification
- or blank.
-
- Operation If the <to_file> is not established, the
- <from_file> is not deleted.
-
- MOVE PROGA.ASM *.BAK
-
- Renames PROGA.ASM to PROGA.BAK within the same
- directory.
-
- MOVE C:\DIRA\*.* A:*.*
-
- Copies all files in the DIRA directory of drive C
- to drive A and deletes all files in DIRA.
-
- If the <from_file> and <to_file> occupy the same
- disk, the MOVE command is executed with a
- rename. If they do not occupy the same disk, the
- MOVE is executed with a COPY and a DELETE.
-
- Should there be no more room on the target disk,
- the MOVE prompts:
-
-
-
- ^insufficient space; retry on new disk? (y/n)
-
- If you change the disk and enter <Y>, the MOVE
- will resume copying the <file_set> starting with
- the complete file that did not fit on the prior
- media. You may use as many media as you need to
- complete the <file_set> move.
-
-
-
-
-
- - 21 -
-
-
-
-
-
-
- Still River Shell MOVE
-
-
-
- Options Option (1) Write on existing files
-
- Option (3) or </Q> Query on multiple operations.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 22 -
-
-
-
-
-
-
- Still River Shell OPTIONS
-
-
-
-
-
-
-
- 3.8 OPTIONS
-
-
- Command OPTIONS
-
- Function The OPTIONS command shows and sets the values of
- shell system options.
-
- Operand 1 None.
-
- Operation The OPTIONS command presents a screen which
- allows you to list and edit the <option_set>.
- The Option values determine some of the behavior
- of the shell.
-
- You move the cursor to select the Option you wish
- to edit. The data making up the the option list
- are switches. Switches are one byte fields with
- a fixed set of alternative values from which you
- choose.
-
- You change the <selected_option> switch value by
- striking the <SPACE_BAR>.
-
- Option 1 Write over existing files (<Y> | <?>).
-
- - <Y> = yes, write on existing files when
- doing a COPY, MOVE or WRITE just as
- PC/MS-DOS does.
-
- - <?> = prompt if a <to_file> already exists.
-
- In the following example, a move instruction
- encounters an existing <to_file> with the option
- set to <?>.
-
-
-
- MOVE *.BAT \DIR1\
- ^ \DIR1\RUN.BAT exists; write? (y/n)
-
- The directory information of both the <to_file>
- and the <from_file> are displayed in the Data
- Window as you are prompted for a decision.
-
-
-
-
-
-
-
- - 23 -
-
-
-
-
-
-
- Still River Shell OPTIONS
-
-
-
- - <Y> = The existing <to_file> is replaced by
- the <from_file>.
-
- - <N> = The operation is bypassed.
-
- Option 2 Remember second operand (<N> | <Y>).
-
- - <Y> = place second operand of prior command
- function into the current command line's
- second operand position when the command is
- selected.
-
- - <N> = command line starts with a blank
- second operand.
-
- Option (3) or </Q>
- Query multiple operations (<Y> | <N>).
-
- - <Y> = prompt before command execution for
- each member of the selected set.
-
- - <N> = Do not prompt
-
- For example:
-
-
-
- DELETE *.BAT
- ^ RUN.BAT ? (y/n)
-
- - <Y> = execute the operation.
-
- - <N> = skip operation; prompt for next
- operation, if any.
-
- The </Q> on appropriate command lines sets Option
- 3 equal to <Y> for this execution of the command,
- for example:
-
- DELETE *.BAT /Q
-
- would present each file in the <.BAT> set before
- execution.
-
-
-
-
-
-
-
-
-
-
-
-
- - 24 -
-
-
-
-
-
-
- Still River Shell RENAME
-
-
-
-
-
-
-
- 3.9 RENAME
-
-
- Command RENAME
-
- Function To rename a file, use the Shell's MOVE command.
-
- Operand 1
-
- Operation
-
- Options
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 25 -
-
-
-
-
-
-
- Still River Shell SORT
-
-
-
-
-
-
-
- 3.10 SORT
-
-
- Command SORT
-
- Function The SORT command sorts the current <file_set>
- list and determines LIST sort criteria.
-
- Operand 1 None.
-
- Operation The sort has several subcommands for sorting the
- <file_set> list based on different criteria. You
- may enter one or more subcommands selecting the
- appropriate letter.
-
- - DATE/TIME Sorts by file date/time in
- ascending order.
-
- - EXTENSION Sorts by file extension in
- ascending order.
-
- - NAME Sorts by file name in ascending order.
-
- - SIZE Sorts by file size in ascending order.
-
- When you enter <ESC>, you return to the main
- Command Selection Line with the <file_set> as you
- last sorted it. All subsequent LIST command
- <file_set> lists are sorted by the criteria last
- selected.
-
- Options None.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 26 -
-
-
-
-
-
-
- Still River Shell TREE
-
-
-
-
-
-
-
- 3.11 TREE
-
-
- Command TREE [<selected_directory>] <CR>
-
- Function The TREE command displays both the parent and
- subdirectory structure of the
- <selected_directory>. In addition, you may
- "move" up and down the directory structure as
- well as LIST, MAKE or REMOVE a directory.
-
- Operand 1 The <selected_directory> whose parent and
- subdirectories are to be displayed. Default:
- Current <selected_directory>.
-
- Operation The directory tree is displayed in the Set
- Window. The <UP/DOWN CURSOR> keys allow you to
- move the <selector> to any directory in the
- list. All subcommand operations address the
- <selected_directory>.
-
- - LIST requests a file list of the
- <selected_directory>.
-
- - MAKE creates a named subdirectory under the
- <selected_directory>.
-
- - REMOVE deletes an empty
- <selected_directory>.
-
- - TREE displays the parent and subdirectories
- of the <selected_directory>.
-
- Options None.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 27 -
-
-
-
-
-
-
- Still River Shell VIEW
-
-
-
-
-
-
-
- 3.12 VIEW
-
-
- Command VIEW [<selected_file> <CR>]
-
- Function The VIEW command displays the contents of a file
- in character format.
-
- Operand 1 <selected_file>.
-
- Operation Normally, you view the <selected_file>. You may
- specify a file only. If the <selector> is on a
- directory; then, you may enter a standard DOS
- file specification
- [<drive>:][\][<directory>\][<file_name>]. No
- wild cards, <?> or <*>, permitted.
-
- You select what area of the file to view with the
- <HOME>, <END>, <PAGE UP/DN> and <CURSOR UP/DN>.
-
- Options None.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 28 -
-
-
-
-
-
-
- Still River Shell WRITE
-
-
-
-
-
-
-
- 3.13 WRITE
-
-
- Command WRITE <to_file><CR>
-
- Function The WRITE command copies the <selected_file_set>
- list, created by the LIST or FIND commands, to
- the <to_file>.
-
- Operand 1 <to_file> Any standard DOS file specification
- [<drive>:][\][<directory>\][<file_name>].
-
- Operation The WRITE creates a file which contains all
- members of the <selected_file_set>. The data
- appears in the same form as the set is presented
- in the Set Window by the LIST or FIND commands.
- The FIND set contains the path and file names of
- files from one or more directories; the LIST set
- contains the files and file descriptions of a
- single directory which satisfy the set
- definition.
-
- Options Option (1) Write on existing files
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 29 -
-
-
-
-
-
-
- Still River Shell XDOS
-
-
-
-
-
-
-
- 3.14 XDOS
-
-
- Command XDOS
-
- Function The XDOS (execute DOS) command allows you to
- execute commands under DOS from the shell
- including prior command recall and full command
- line edit.
-
- Operand 1 None.
-
- Operation When you execute the XDOS command, you are
- presented with a standard DOS prompt showing the
- current drive and directory on the command line.
-
- C:\DOC>_
-
- You may enter any DOS command string. You may
- edit the command line with the normal shell
- command line edit features. You may enter as
- many commands as you wish. As you execute DOS
- commands and DOS responds, the shell screen moves
- up and, eventually, off the display as it is
- replaced by the DOS dialogue.
-
- You may recall a prior DOS command line, then
- edit and execute it.
-
- The command line edit functions for XDOS are the
- same as the shell commands with the exception of
- these special XDOS edit features:
-
- - <ESC> - clears the command line. If the
- command line is blank, <ESC> escapes the
- XDOS command presentation and returns to the
- shell command selection presentation.
- Please note: the default <selected_drive> or
- <selected_directory> may have been changed
- by your DOS commands.
-
- - <UP/DOWN CURSOR> - replaces the command line
- with the selected previous DOS command line
- from the command stack. The prior command
- line stack keeps about 20 of your most
- recent commands to DOS which you can recall,
- edit and execute.
-
-
-
-
- - 30 -
-
-
-
-
-
-
- Still River Shell XDOS
-
-
-
- The DOS PATH command can not be used to alter the
- system path while under XDOS; you must exit the
- shell to update the system environment.
-
- Options None.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 31 -
-
-
-
-
-
-
- Still River Shell <function_key>
-
-
-
-
-
-
-
- 3.15 <function_key>
-
-
- Command <Fn>
-
- Function The <function_key> executes a command line under
- DOS including the state of the shell as
- parameters.
-
- Operand 1 None.
-
- Operation When a Function Key, <Fn>, is entered, a command
- line is executed under XDOS. The command line is
-
- <SRF><n><case> <selected_set> <default_drive>
- <selected_file_path> <selected_file_name>
- <selected_file_extension>
-
- <n> the number of the <function_key>
- pressed
-
- <case>
-
- - A = <ALT>
-
- - S = <SHIFT>
-
- - C = <CTRL>
-
- - <null> = <NORMAL> no shift.
-
- <selected_set>
- (%1) Current set description
- <drive><path><filename>
-
- <default_drive>
- (%2) DOS default drive
-
- <selected_file_path>
- (%3) DOS path, less drive, of the
- <selected_file>
-
- <selected_file_name>
- (%4) First 8 characters of the
- <selected_file> name or up to period
-
- <selected_file_extension>
- (%5) Extension of <selected file>
-
-
-
- - 32 -
-
-
-
-
-
-
- Still River Shell <function_key>
-
-
-
-
- For example, if you pressed <F8> and the
- <selected_file> was PROGA.C in \SYS\C directory
- in a LIST (*.C), then the following command is
- passed to DOS by the shell:
-
-
-
- SRF8 C:\SYS\C\*.C C \SYS\C PROGA C
-
- You must create a SRFn file as either a batch
- file or program for every function key you plan
- 2
- to use.
-
- To make <Function_Key_2>+<ALT> cause the
- <selected_file> to execute:
-
- Define SRF2A.BAT as:
-
- %4.%5
-
- When <F2>+<ALT> are pressed, the shell executes
- the command line:
-
- SRF2A C:\SYS\C\*.EXE C: \SYS\C PROGA EXE
-
- Which generates:
-
- PROGA.EXE
-
- Options None.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- ----------
-
- 2. See Shell Techniques for file definition and key assignment
- protocols.
-
-
-
- - 33 -
-
-
-
-
-
-
- Still River Shell Shell Techniques
-
-
-
-
-
-
-
-
-
- Chapter 4
-
- User Guide: Still River Shell Techniques
-
-
-
- (Included in unabridged, printed documentation only)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 34 -
-
-
-
-
-
-
- Still River Shell Command Usage
-
-
-
-
-
-
-
-
-
- Chapter 5
-
- Reference Guide: Command Usage
-
-
-
- (Included in unabridged, printed documentation only)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 46 -
-
-
-
-
-
-
- Still River Shell Window Definitions
-
-
-
-
-
-
-
-
-
- Chapter 6
-
- Reference Guide: Window Definitions
-
-
-
- (Included in unabridged, printed documentation only)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 51 -
-
-
-
-
-
-
- Still River Shell Message Summary
-
-
-
-
-
-
-
-
-
- Chapter 7
-
- Reference Guide: Message Summary
-
-
-
- (Included in unabridged, printed documentation only)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 57 -
-
-
-
-
-
-
- Still River Shell Design Philosophy
-
-
-
-
-
-
-
-
-
- Chapter 8
-
- A Little Design Philosophy
-
-
-
- (Included in unabridged, printed documentation only)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 61 -
-
-
-
-
-
-
- Still River Shell
-
-
-
-
-
-
-
- Index
-
-
- (Included in unabridged, printed documentation only)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-